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PREFACE 


Before reading this manual, you should be familiar with the BASIC-11l 
language and the RT-11_ system. If necessary, read the following 
manuals before reading this User's Guide: 


® BASIC-11 Language Reference Manual (DEC-11-LIBBB-A-D) 
e Introduction to RT-1ll 

or 
e RT-11 System User's Guide 


Most features of BASIC-11/RT-11l V2 are the same as in other versions 
of BASIC-11l. (DIGITAL's name for a family of BASICs for the PDP-11). 
These features are described in the BASIC-11 Language Reference Manual 
(DEC-11-LIBBB-A-D). ee EP ee ee es Ce ee 


This guide describes the system dependent features of BASIC-11/RT-11. 
They are: 


Procedure for starting BASIC 

Effect of the CTRL/C key command 

Accuracy of storing numbers 

Format of error messages 

Format of the file specification 

Effects of parameters in the OPEN statement 
Procedure for checking files 

Effect of superseding files 

Effects of the utility functions 

Procedure for using assembly language routines 
Procedure for terminating BASIC 


All BASIC users should read this guide excluding only Chapter 4. Only 
users who are adding assembly language routines to BASIC need to read 
Chapter 4. Chapter 4 assumes that you are an experienced RT-11 MACRO 
programmer. 


This guide assumes that you have linked BASIC according to the 
procedure described in the BASIC-11/RT-11 Installation Guide 
(DEC-11-LIBTA-A-D). 


DOCUMENTATION CONVENTIONS 


This section describes the documentation conventions, notations, and 
symbols used throughout this manual. 


The following symbols denote special terminal keys that you will use 
frequently when using BASIC. 


Symbol Meaning 
While pressing the CTRL key, type the letter indicated 
after the slash. 
Type the RETURN key. 
€s0) Type the ESCAPE key (ALTMODE on some terminals). 
@ED) Type the DELETE key (RUBOUT on some terminals). 


In addition, this manual uses certain conventions when describing the 
format of statements, functions, and commands. 


These are: 
Convention Meaning 
The enclosed elements are optional. For example: 
[ ] [tet | variable=expression 

A choice of one element among two or more 

possibilities, for example: 
THEN statement 

IF relational expression<THEN line number 

GO TO line number 


a oe Preceding element can be repeated as indicated. 
For example: 


line number CLOSE#expri1,#expr2,... 


Items in Type these elements exactly as they appear in the 
capital format, for example: 
letters and 
special LET 
symbols RUN 
# 


Items in capital letters are called keywords. 


Items in Replace these elements according to the 
lower case description provided in text. See below for list 
letters of commonly used lower case items. 


This list describes some lower case items commonly used in format 
descriptions. The general meaning of each item is given. Unless a 
specific format description places restrictions on an item, its 
general meaning applies. See the BASIC-11l Language Reference Manual 
for more information on these items. 
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Lower Case Abbreviation Meaning 


Item 

expression expr Any valid BASIC-11 expression. 
Tt is always a numeric 
expression unless the 
description specifically states 
that it can be a numeric or 
string expression. For 
example: (5*SIN(X))“Y 

file specification --- A file specification as 
described in Section 2.1 

integer int Any positive integer number 
constant or any positive 
numeric constant that could be 
an integer if a percent sign 
were put after it. For 
example: 5%, 3%, 2, 7 

line number SSS Any valid line number. For 
example: 10, 100, 32767 

string S25 Any string expression. For 
example: 
"ABC", CS$+SEGS(AS,3,4) 

variable var A floating point, integer or 


string variable. 
If more than one lower case word appears in a format, the words are 
numbered 1, 2, 3, etc. For example: 
CLOSE #expril,#expr2,#expr3,... 


Throughout this manual, the term BASIC means BASIC-11 or 
BASIC-11/RT-11. 


To differentiate between what BASIC prints and what you type, the user 
type-in is printed in red ink. For example: 


RUNNE 

WHAT NUMBERS? S910 
THE SUM TS LS 

RE AY 


All user type-in is terminated by the RETURN key unless the text 
indicates a different terminator. 
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CHAPTER 1 


GETTING STARTED WITH BASIC-11/RT-11 


1.1 OPTIONAL FEATURES 


BASIC-11/RT-11 has numerous optional features. If you include all 
optional features, any feature described in the BASIC-11 Language 
Reference Manual or in this guide is available. By excluding some or 
all optional features, you can increase the amount of memory available 
for programs or have faster program execution, or both. 


BASIC-11/RT-11 has available the following optional features: 


Statements 

CALL 

PRINT USING 

Commands 

SUB 

RESEQ 

Functions 

SQR SYS ABS SEG$ 

SIN RCTRLO SGN VAL 

cos ABORT BIN TRMS 

ATN TTYSET oct STRS 

LOG CTRLC LEN PI 

LOG10 RCTRLC ASC INT 

EXP TAB CHRS DATS 
RND POS CLKS 

Miscellaneous 


@ Double precision arithmetic 

@e Long error messages 

@e Exponentiation (e.g., the expression AB) 

e Ability to run BASIC as foreground or background job 


e Features affecting program space availability and program 
execution speed 


You must specify the inclusion or exclusion of some optional features 
at BASIC linking time. Others you select at BASIC run time. The 
features you can choose when you link BASIC are: 
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All optional statements 

All optional commands 

SQR, SIN, COS, ATN, EXP, LOG, and LOG10 functions 
All miscellaneous optional features 


The features you can choose at run time are the following optional 
functions: 


sys ABS SEGS 
RCTRLO SGN VAL 
ABORT BIN TRMS 
TTYSET ocT STRS 
CTRLC LEN PI 

RCTRLC ASC INT 
TAB CHRS$ DATS 
RND POS CLKS 


Before using BASIC you must link a version with the optional features 
you want. See the BASIC-11/RT-11 Installation Guide for instructions 
to link BASIC and for information about allowed program size and speed 
of execution tradeoffs. 


1.2 STARTING BASIC 

You can use BASIC with either the single-job (SJ), 
foreground/background (FB), or extended memory (XM) RT-11 V3 monitor. 
When using the FB or XM monitor, you can run BASIC as either’ the 
foreground or background job. 

Before starting BASIC, you must bootstrap RT-11l and enter the DATE and 


TIME commands. See the Introduction to RT-1l for a description of 
these procedures. 


1.2.1 Running BASIC With the Single Job Monitor or as the Background Job 
To run BASIC with the SJ monitor or as the background job, enter 
either the BASIC or the RUN command. The BASIC command runs the file 
BASIC.SAV on your system device. To enter the BASIC command, type: 
»GASTC 
To use another version of BASIC, type: 
+RUN file specification 
where: 


file specification specifies the file containing the 
version of BASIC that you want. 


For example, if you have a version of BASIC on device DXl: with file 
name BAS8K, and you want that version instead of the one in BASIC.SAV, 
you should enter: 

sRUN DX RASS 
If you specify a file that does not exist, RT-1l prints the message: 


PRMON@FeF idle mot found 
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If there is not enough room to run BASIC, one of the following 
messages is printed: 


NOT ENOUGH MEMORY FOR BASTC 
or 
PTRMON@F Not enousth memory 


This error often results from a large foreground job that has not been 
unloaded. 


If there are no errors, BASIC prints an identifying message and 
inquires whether you want the optional functions that are selectable 
at run time. 


+BASTIC 
BASTC@LI/R TTL VOR@xx 
OPTIONAL FUNCTIONS CALL» NONE» GOR TNDTUTIUALD? 


To include all of the optional functions, type an A. To exclude all 
of the optional functions, type anN. (You must always terminate 
input to BASIC with the RETURN key.) In response to your A or N, BASIC 
includes or excludes all the functions and then prints the READY 
message. For example: 


OPTIONAL FUNCTIONS CALL» NONE» OR TNDTUTIUAL) PA 
REATIY 


Typing only the RETURN key in response to the optional functions 
request is equivalent to typing A. 


If you want to choose among the optional functions individually, type 
an I. BASIC then prints an inquiry for each function individually. 
To include a function type a Y; otherwise type an N. Typing only the 
RETURN key in response to the function request is equivalent to typing 
¥. If you type anything else, BASIC repeats its request. After you 
have typed a Y or an WN in response to each function inguiry, BASIC 
prints the READY message. For example: 


OPTIONAL FUNCTIONS (Als NONE» OR ITNDIVIDUALI® I 
SYS? N 
ROTRLOP WN 





PRINIVP 
ARS? 


SGN? 


Y 
cfs 
Y 
Y 
BIN? ¥ 
Y 
N 
N 





A 
Ch 


VAL? N 
TRMG&? ON 
STREP N 
BIL? N 
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INT? 
LATE? N 
CLG? ON 
REALIY 


1.2.2 Running BASIC As the Foreground Job 
To run BASIC as the foreground job, use the FRUN command. Type: 


«FRUN file specification /Ninumber. 


where: 
file specification specifies the file containing BASIC 
number is the size of the user area (i.e., the 


number of words to be reserved). It 
must be 1000. or greater. The decimal 
point identifies the number as decimal, 
not octal. 


You must specify the user area size, or else no area will be reserved 
and BASIC will not be able to run. 


The user area will actually be approximately 100 words more than you 
request. For example, the following command reserves approximately 
3100 words. 


«FRUN BASTC/SNI 3000. 
If the file specified does not exist, RT-11l prints the message: 
?KMON@Fe Fide mot found 


If the number of words requested in the FRUN command is not large 
enough, BASIC prints the message: 


NOT ENOUGH MEMORY FOR BASIC 


If there are no errors, RT-1ll prints a dot and the F> message to 
indicate that the next message is printed by the foreground job. 
BASIC then prints an identifying message and inquires whether you want 
the optional functions. For example: 


*+FRUN BASTC/NE 3000, 


F e 
BASIC@L1/RT=11 VO2=xx 
OPTIONAL FUNCTIONS CALL» NONE» OR INDIVIDUAL >? 


Type a CTRL/F and then answer the optional function inquiry as 
described in the previous section. 


NOTE 


To use a device other than the system 
device, you must load the handler before 
you run BASIC in the foreground. See 


the RI-1l System User's Guide for more 
information about foreground jobs. 
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1.2.3 Running BASIC From an Indirect File 


You can run BASIC and answer the initial dialogue by using an indirect 
file. You can only run BASIC in this way as the background job or in 
the single job monitor. This technique is useful when you select the 
optional functions individually. 


You cannot enter any BASIC command, program line, or immediate mode 
statement through an indirect file. 


To create the indirect file, direct the editor to create a file with a 
file type .COM that contains all anticipated responses to system 
queries. For example: 


eR EMT 
XEWMINRUN. COM €SO Eso 
KIF BASIC 

I 


ZARA eZee KAKAKK SSS SSS 


N 
¥ 

N 

N 

E59 ESD 

KEX €SO ESO 


To start BASIC, type an @ ("at" sign) followed by the file name. The 
complete initial dialogue is printed on the terminal. For example: 


«@MTNRUN 


oR BASIC 

BASTO-LA/RT LL VOR kx 

OPTIONAL FUNCTIONS CALL» NONE y OR TNGIVINUALO? F 
SYS? N 

ROTREO? N 

ABORT? N 

TTYSET? N 

CTRLG & ROTRLOP? N 

TAR? N 
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RNG? 
ARG? 
SON? 
BIN? 
OCT? 
LEN’? 
AS? 
CHRBP ON 
FOS? 
SEG? N 
VAL? ON 
TRMS? ON 
STR&? N 
FL? N 

INT? Y 
TATH#? N 
CLINGS? N 


ZzZ2zxx<«~<< 


z 


REATIY 


See the RT-1l System User's Guide for more information on using 
indirect files. 





1.3 STOPPING BASIC PROGRAMS (CTRL/C COMMAND) 
To stop execution of a BASIC program, use the CTRL/C command. If you 
type one CTRL/C, BASIC interrupts your program the next time it 
requests input. Tf you type two consecutive CTRL/C's, BASIC 
interrupts your program immediately. After BASIC interrupts your 
program, it prints: 

STOF AT LINE xxxxx 

REALTY 
where: 


XXXXX is the number of the line that BASIC was executing when 
the CTRL/C command halted the program. 


However, if you were not executing a program line, BASIC prints: 
STOF 
REALTY 

When you type CTRL/C, the system prints “C. For example: 


LO GO. TO 14 
FUNNE 


ok Oe © 
STOP AT LINE 1 


REALTY 


NOTE 


CTRL/C does not return control to the 
RT-11 monitor. You must type the BYE 
command (see Section 1.4) to return 
control to RT-1l1. 
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1.4 TERMINATING THE SESSION (BYE COMMAND) 


To terminate a session with BASIC, type the BYE command. The BYE 
command returns control to the RT-11 monitor, which prints its 
prompting period. For example: 


BYK 


Once you have entered the BYE command you cannot use the RT-11 REENTER 
command to return to BASIC. Instead, you must restart BASIC as 
described in Section 1.2. If you want to reuse your BASIC program, 
Save it before entering the BYE command. 


Tf you ran BASIC as the foreground job, you must unload it after you 
enter the BYE command. Type: 


eUNLOAL FG 


1.5 FLOATING POINT NUMBER PRECISION 


You can use BASIC with either single or double precision arithmetic. 
Single precision arithmetic allows floating point numbers to seven 
digits of precision. Thus, single precision BASIC stores the numbers 
1.000001 and 1.000000 (seven digits) differently but stores 1.0000001 
and 1.0000000 (eight digits) as the same number. Double precision 
arithmetic allows you to specify floating point numbers to 15 digits 
of precision. 


If you need more than seven digits of precision, you should use BASIC 
with double precision arithmetic. However, double precision BASIC has 
two disadvantages. 


1. It allows less BASIC program space, because BASIC itself 
requires more memory and because all floating point 
constants, variables, and arrays require twice the memory 
that single precision would need. 


2. Arithmetic operations and functions run more slowly with 
double precision than with single precision. 


The PRINT statement only prints six digits even when you are using 
double precision arithmetic. Consequently, if you want to print a 
number with more than six digits, you must use the PRINT USING 
statement or the STR$ function. The following example was run using 
double precision arithmetic. 


LISTNH 

LQ X84. 237194297 

20 Y26 49090909 

SO FRINT XXY 

40 PRINT USTNG "ARR Stes RY 9 KRY 
SO PRINT STRBCXRY) 


RE ALY 


GETTING STARTED WITH BASIC-11/RT-11 


RUNNE 
a9 2752 
29 A751L4601 


29, 2751460144389 
REEATIY 


Double precision compiled BASIC uses the default file type -BAX while 
single precision compiled BASIC programs have the default file type 
-BAC. The different default file types are necessary because double 
precision BASIC cannot read a program compiled by single precision 
BASIC and vice versa. If you are using double precision BASIC and 
specify the file type of a program compiled by single precision BASIC 
or vice versa, the results are unpredictable. 


1.6 SYSTEM DEPENDENT ERROR MESSAGES 


Some of the error messages listed in the BASIC-1l Language Reference 
Manual either have special meaning in BASIC-11/RT-1l or are not 
produced by it. These error messages are 


?CANNOT DELETE FILE (?CDF) 
BASIC-11/RT-11 does not produce this message. 


?ERROR CLOSING CHANNEL (?ECC) 
BASIC-11/RT-11 does not produce this error message. If an error 
occurs when BASIC-l1/RT-1l1 is trying to close a channel, 
BASIC-11/RT-11 prints the ?CHANNEL I/O ERROR (?CIE). 


?FILE ALREADY EXISTS (?FAE) 
BASIC-11/RT-11 does not produce this message. 


?FILE PRIVILEGE VIOLATION (?FPV) 
BASIC-11/RT-11 does not produce this message. 


?FILE TOO SHORT (?FTS) 
The file is too small to contain the output. If the error occurs 
in a data file, specify a larger FILESIZE. If the error occurs 
in a program file, delete unused files with the UNSAVE command 
and then retry. 


PILLEGAL DEF (?IDF) 
BAISC-11/RT-11 does not produce this message. 


?PILLEGAL FILE LENGTH 
The FILESIZE specified was less than -1 (see Section 2.2). 


PILLEGAL RECORD SIZE (?IRS) 
BASIC-11/RT-11 does not produce this message. 


?NOT A VALID DEVICE (?NVD) 
BASTC-11/RT-11 does not produce this message. 


?NOT ENOUGH ROOM (?NER) 
There is not enough room for the FILESIZE specified. Delete 
unused files with the UNSAVE command. 


2.1 


BASIC uses the standard RT-11 file specification. 


FILE SPECIFICATION 
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FILES 


Its format is: 


[device :] [filename] [. type] 


wheres 


device 


filename 


type 


is the device name. It 


can be any device name 


listed in Table 2-1 or any assigned device name (see 
the RT-11 User's Guide). 


ig the one- to six-character name of the file. 


is the zero- 


to three-character type of the file. 


Table 2-1 


RT-11 Device Names 


Card Reader 
Cassette 
RLO1 Disk 
RKO6 Disk 
RPO2 Disk 


RJSO3/4 Disk 


DECtape 

RX11 Diskette 
Line Printer 

TJUL6 Magtape 
TM1l Magtape 


Combined high-speed paper tape reader and punch 


RF11 Disk 
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Table 2-1 (Cont.) 
RT-11 Device Names 


coe fice 


RKO5 Disk 







Console Terminal Keyboard/Printer 









System device (the volume from which the 
monitor was bootstrapped) 


The default storage volume 


Tf you do not specify any of the elements of the file specification, 
BASIC uses a default value. 


The default device is DK:. The default for the file name and file 
type depends on the statement or command in which the file specifica- 


tion appears. Table 2-2 shows the file name defaults, and Table 2-3 
shows the file type defaults. 


Table 2-2 
Default File Names 


Statement or Command Default 


SAVE, REPLACE, COMPILE the current program name 


OLD,APPEND, CHAIN the file name NONAME 
OVERLAY 


UNSAVE,OPEN, KILL no default but prints 

NAME the ?ILLEGAL FILE 
SPECIFICATION (?IFS) 
error message instead. 





Table 2-3 
Default File Types 


Statement or Command Single precision Double precision 
BASTC Default BASIC Default 


OPEN, KILL,NAME - DAT -DAT 


SAVE, REPLACE, UNSAVE » BAS ~BAS 
APPEND 


COMPILE - BAC » BAX 


RUN,OLD »~BAC (and if a .BAC »-BAX (and if a 
cannot be found .BAS) .~BAX cannot be 
found .BAS) 





FILES 


When you create a file whose file specification is the same as an 
existing file, the older file will be deleted (superseded) when the 
new file is closed. You can avoid unwanted deletions by using the 
SAVE command to save new files. If a SAVE command specifies a file 
name that already exists, BASIC-11 prints the following error message: 


TUSE REPLACE CPREL) 


This gives you an opportunity to decide whether you want to supersede 
the old file, or store the file under a different file specification. 


2.2 THE OPEN STATEMENT - SYSTEM DEPENDENT FEATURES 
The format of the OPEN statement is: 


[{ FOR INPUT 
OPEN string |\FOR OUTPUT/| AS FILE [#] exprl [DOUBLE BUF] 


[,RECORDSIZE expr2] [,MODE expr3] [,FILESIZE expr4] 


where: 

string is a file specification as described in 
Section 2.1. 

exprl is the channel number of the file. Tt can 
have any value between 1 and 12. 

DOUBLE BUF causes the file to be double buffered. 
Double buffering increases the speed of some 
file operations but requires additional 
memory for the second buffer. 

RECORDSIZE expr2 is ignored if specified. 

MODE expr3 is ignored if specified. 

FILESIZE expr4 if positive, specifies the maximum number of 


256-word blocks the file can occupy. If 
FILESIZE is missing or expr4 equals 0, it 
requests the standard BASIC-11/RT-11l file 
allocation (that is, either half the largest 
free area or all of the second-largest free 
area, whichever is larger). If expr4 equals 
-1, it requests the absolute largest free 
area. If expr4 is less than -l, the error 
message ?ILLEGAL FILE LENGTH appears. 


The elements of the OPEN statement described above are the system 
dependent elements. The other elements of the OPEN statement are 
described in the BASIC-11 Language Reference Manual. 


2.3 LISTING YOUR FILE DIRECTORY 


You must return control to the RT-11 monitor before listing your file 
directory. First save your current BASIC program (if you wish to 
reuse it later) and then enter the BYE command. The monitor prints 
the dot prompt. For example: 


FILES 


SAVE TEMF 


REALTY 

BYE 
Following the prompt, type the RT-11 DIRECTORY command. A simplified 
format of the RT-11 directory command (see the RT-11 System User's 
Guide for a complete description) is: 


DIREC TORY [PRINTER | file specification 


where: 

/PRINTER specifies that the directory is to be 
printed on the line printer. (If 
omitted, the directory is printed on the 
terminal.) 

file specification specifies the files that you want 


listed. If you omit the file 
specification, all files are listed. 


The DIRECTORY command wildcard feature allows you to specify files 
with similar file names, or similar file types, or both. If you 
substitute an asterisk for the file name but specify a file type, all 
files with that file type are listed. For example, the following 
command lists all BASIC source programs on the line printer: 


eQIRECTORY/FPRINTER x. BAS 


Similarly, if you substitute an asterisk for the file type, but 
specify a file name, all files with that file name are listed, 
regardless of file type. For example, the following command lists all 
files with the file name TEST: 


*CLRECTORY/FRINTER TESTO 


If you specify a percent sign in place of any characters in a file 
name or file type (for example, TEST%%.BAS), then all the files whose 
specifiers match the other characters in the specification are listed 
(TESTAB.BAS, TESTO1.BAS, and TESTER.BAS would be listed, if they 
exist, for the specification TEST%%.BAS). 


To list all the BASIC programs and compiled BASIC programs, type: 
¢TIRECTORY x. BAY 


Note that this command also lists files with the file type .BAK and 
-BAT. Because the specification /PRINTER is absent, listing occurs on 
the terminal. 


After listing your directory, you can return to BASIC by using the 
BASTC command, then restore your saved program with the OLD command, 
and finally, delete the temporary file. For example: 


oRASIC 
BASIC-Li/RT-11 YOR-xx 
OPTIONAL FUNCTIONS CALL» NONE? OR INDIVIDUAL)? A 


REALY 

OLD TEMF 
REALY 
UNSAVE TEMP 
REALY 


CHAPTER 3 


UTILITY FUNCTIONS 


3.1 BASIC UTILITY FUNCTIONS 
BASIC has utility functions to: 
e Change the terminal width (TTYSET) 
e Cancel the effect of CTRL/O (RCTRLO) 
e Disable CTRL/C (CTRLC and RCTRLC) 
e Terminate your program (ABORT) 
e Input a single character from your terminal (SYS) 
e Terminate BASIC (SYS) 
e Check if a CTRL/C has been typed (SYS) 
e Enable lower case support (SYS) 


In the following sections, BASIC-11 utility functions are shown in the 
context of a LET statement with a dummy target variable, as follows: 


[Ler] variable = utility function 
where: 
variable is the target variable. 
utility function is one of the functions described in this 
chapter. 


Actually, utility functions can appear in any arithmetic expression. 
The LET statement format is recommended because it is the simplest 
statement, and consequently, produces easier-to~read programs. 


3.2 SETTING THE TERMINAL MARGIN (TIYSET FUNCTION) 

Use the TTYSET function to set your terminal's right margin. BASIC 
prints on a line until a number or string would extend past the margin 
you set. BASIC then prints a return and line feed on the current line 
and prints the string or number on the next line. 

The format of the TTYSET function is: 


[Let] var iable=TTYSET (255%,expression) 
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where: 

variable is the target variable and contains an undefined 
value after the statement is executed. 

255% is either a numeric constant (as specified in 
format) or an expression with an integer value of 
255 (for compatibility with other versions of 
BASIC). 

expression specifies the right margin of the terminal. The 


margin is set to the value of 
l. If the expression equals 
change the previous margin. 

the full 


For example, to set BASIC to print to 


DECwriter II (132 columns), type: 
A=TTYSET (255% 133%) 


To set BASIC to print to the full width of a vT50 
columns), type: 


AZ TTYSET (225% 9814) 


the expression minus 
0, BASIC does not 


width of an LA36 


display terminal (80 


If you do not specify the TTYSET function, BASIC assumes a terminal 
with 72 columns. 
Ensure that the system's margin for your terminal is equal to or 
greater than the margin you specify in TTYSET. 
If the value of the expression is less than 0, equal to 1, or greater 
than 256, BASIC prints the ?ARGUMENT ERROR (?ARG) message. If the 
first argument has a value other than 255, BASIC prints the same 
message. 
3.3 CANCELING THE EFFECT OF CTRL/O (RCTRLO FUNCTION) 
BASIC stops terminal output when the CTRL/O key is typed; however, 
the RCTRLO function causes BASIC to resume printing. Use the RCTRLO 
function to ensure that certain data is printed on the terminal even 
if a CTRL/O has been typed. 
The format of the function is: 
[ue] variable=RCTRLO 

where: 

variable is the target variable and contains an undefined 


value after the statement is executed. 


Consider the following example: 
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LISTNH 

1O REM FROGRAM TO INFUT DATA 
20 REM FROM FILE AND PRINT SUM 
30 OPEN "NUMBR" FOR TNFUT AS FILE del 
40 PRINT "DATA IN FILES" 

SO TF END #1 THEN 100 

60 TNFUT #1 +t 

70 PRINT 1 

80 Te T+h 

90 GO TO So 

100 A#RCOTRLO 

110 PRINT 

120 PRINT "SUM@" $7 


RE ALY 
RUNNH 


4 
1é 
147 
26 

SUMs# 4172 


REATY 
While BASIC executes the loop from line 50 to line 90 it prints out 


numbers. If CTRL/O is typed BASIC stops printing. But when BASIC 
executes line 100, BASIC resumes printing. 


3.4 DISABLING CTRL/C (RCTRLC AND CTRLC FUNCTIONS) 
In certain parts of the program you may need to override CTRL/C 
interrupts from the terminal. The RCTRLC function disables CTRL/C and 
prevents it from stopping the BASIC program. The cCTRLC function 
enables the CTRL/C key command. 
The format of the functions are: 

[net] variable=RCTRLC 

[Let] variable=CTRLC 


where: 


variable is the target variable; it contains an undefined 
value after the statement is executed. 


After BASIC executes the RCTRLC function, typing CTRL/C on the 
terminal does not stop the program. 


After BASIC executes the CTRLC function, typing CTRL/C stops the 
program. BASIC does not save any CTRL/C that is typed while CTRL/C is 
disabled. If the program encounters a CTRL/C function, and no _ prior 
RCTRLC function is in effect, the CTRL/C function has no effect. 


When BASIC prints the READY message, it automatically enables the 
CTRL/C key command. 


For example: 
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LISTNH 

16600 REM 00 NOT ALLOW INTERRUPTS 
1010 A=ROTRILC 

1020 FRINT "NO INTERRUFTS" 


LO30 FOR T= 1 TO 1000 \ S#S+2 \ NEXT I 
1100 REM NOW ALLOW INTERRUPTS 
L116 2 TRC 





L120 FRINT "INTERRUPTS OKAY" 

1130 FOR To = 1 TO 1000 \ S#S4+I \ NEXT IT 
S2767 ENT 

REALTY 

RUNNH 


NO INTERRUETS 
INTERRUPTS OKAY 
STOF AT LINE Liao 
READY 
For information on a system function that determines if CTRL/C has 
been typed while CTRL/C is disabled, see Section 3.6.3. 
NOTE 
Once CTRL/C is disabled it is not 
possible to interrupt BASIC. Do not 


disable CTRL/C until your program is 
debugged. 


3.5 TERMINATING YOUR PROGRAM (ABORT FUNCTION) 


If you want a program to delete itself from memory when it terminates, 
use the ABORT function. The ABORT function is equivalent to an END 
statement except that ABORT can optionally delete your program from 
memory and change the program name to NONAME (equivalent to the SCR 
command). 


The format of the ABORT function is: 


[Let] var iable=ABORT (expression) 


where: 
variable is the target variable; it contains an undefined 
value after the statement is executed. 
expression determines if the program is to be deleted from 


memory. If expression equals 0, BASIC does not 
delete the program. If expression equals 1, BASIC 
deletes the program. 


Consider the following examples: 
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Delete from memory 
when program completed 


List 

ABORT Bi IUN@ P27 Laem das 
1G FRINT "123" 

20 AZABORT C1 > 

3O PRINT "456° 

READY 

RUNNEH 

123 

READY 

LIST 

NONAME 21 JUNe 76 Laisa s3o0 
READY 


SYSTEM FUNCTIONS 


Do not delete when 
program completed 


LIST 

ABORT 21—-JUN=77  14t54s00 
LO PRINT "123" 

20 A&ABORT (CO) 

SO FRINT "454" 

REATIY 

RUNNH 

123 

REATIY 

LIST 

ABORT 2i-JUN@75 14254230 
10 PRINT "23" 


20 A#ABRORT(O) 
3O PRINT "456" 


RE ATHY 


System functions perform system-dependent operations. 


The formats of the system functions are: 


[Lec] variable= SYS(expressionl 


,expression2 ) 


where: 
variable is the target variable. 
expressionl determines the function to be performed. 
expression2 is an optional argument used in some system 
functions. 
Table 3-1 summarizes the functions performed according to the 
specified value of expressionl. Any value of expressionl other than 


those specified causes BASIC to 
mesSage. 


print 


the ?ARGUMENT ERROR (?ARG) 
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Table 3-1 
Summary of System Functions 














Value of Function Performed 


expressionl 














Processes input one character at a time. Target 
variable contains the ASCII value of the next 
character typed at the terminal. 


Terminates BASIC and returns control to system 
monitor (equivalent to the BYE command). 


Determines if CTRL/C has been typed while CTRL/C is 
disabled by RCTRLC function. Target variable equals 
1 if CTRL/C has been typed and equals 0 if CTRL/C has 
not been typed. 

















Enables or disables lower case input from your 
terminal. If expression2 equals 0, lower case 
character input is allowed. If expression2 equals l, 
lower case character input is converted to the 
equivalent upper case character input. 










3.6.1 Single Character Input 


Use the single character input system function, SYS(1), to process 
input one character at a time. 


SYS(1) returns the seven-bit ASCII value of any character typed on the 
terminal except CTRL/C. (See the BASIC-1l Language Reference Manual 
for a list of the ASCII values.) If CTRL/C is typed when BASIC is 
executing SYS(1) and CTRL/C is enabled, then BASIC prints the STOP and 
READY messages. If CTRL/C is disabled, then BASIC continues executing 
SYS(1) and waits for another character. BASIC cannot process the 
character until you type the RETURN key. 


LISTNH 

10 FRINT "TYPE A CHARACTER? "3 

20 A#=SYSC1) 

40 PRINT "THE ASCII VALUE OF "SCHRECAIE* IS*GAa 
REALLY 

RUNNH 

TYPE A CHARACTER? Zz 

THE ASCIT VALUE OF Z IS 90 


REAIVY 


3.6.2 Terminating BASIC 


To terminate BASIC from a BASIC program, use system function SYS(4). 
It is equivalent in effect to the BYE Command. 


For example: 
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LISTNH 
10 PRINT "GOODBYE" 
20 A=SYS(4) 


REALY 
RUNNH 
GOODBYE 


e 


3.6.3 Checking for CTRL/C 


If you have disabled CTRL/C with the RCTRLC function and want to check 
if cCTRL/C has been typed, use system function SYS(6). The function 
returns a 1 if CTRL/C has been typed and a 0 if it has not been typed. 


For example: 


LISTNH 

10 AFRCTRLO N REM Disable CTRL/C. 
30 ReSYS(6) \ REM Check for CTRIL/C. 
40 IF Bel THEN 100 

5QO PRINT "STILL EXECUTING" 

60 GO TO 3o 

100 PRINT “PROGRAM TERMINATING" 

1160 ASCTRLC REM Reenahle CTRL/C. 
120 A=ABORTCI1) 


REALLY 
RUNNH 


STILL. EXECUTING 
STILL EXECUTING 
STILL EXECUTING 
PROGRAM TERMINATING 


REATIY 


3.6.4 Enabling Lower Case Support 


If you want to enter lower case characters at your terminal, use the 
system function SYS(7,expr2). The RT-11 system usually converts all 
lower case alphabetic characters to upper case. Executing the 
function SYS (7,0) causes RT-11 to stop converting lower case 
characters and to pass them unchanged. To cause RT-11 to resume 
converting lower case characters, you must execute the function 
SYS(7,1). After you exit from BASIC, the monitor continues to process 
characters as it did before BASIC was active. 


The following example demonstrates how to enable and disable lower 
case. The program is first run to enable lower case by causing the 
function SYS(7%,0%) to be executed. After this the program is 
modified to allow the user to enter a lower case response. Finally, 
the modified form of the program is run; this disables lower case. 
The modified program is then saved. 
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L.ISTNH 

10 REM FROGRAM TO CHANGE LOWER CASE CONVERSION 

20 FRINT "DO YOU WANT TO ENTER LOWER CASE CHARACTERS (Y OR N)"$ 
30 INFUT AS 

40 IF AS="Y" THEN 100 

SO IF Ages "N" THEN 20 

60 ##SYSC7%91%) \ REM DISARLE LOWER CASE 

70 GO TO 32767 

100 A#=SYSC7%490Z%) \ REM ENABLE LOWER CASE 

$2767 END 


REALTY 
RUNNH 


nO YOU WANT TO ENTER LOWER CASE CHARACTERS (CY OR ND? Y 





REALTY 

45 af abe"y" bLnner 160 \ rem Check for lower case 

sub 5G @200iF aboot" ther 2O \ Rem Cheek for lower Case nm 

SO IF ASs2"N" THEN if ag<s'n" then 20 \ Rem Check for lower case m 
REALLY 

Listnin 


10 REM FROGRAM TO CHANGE LOWER CASE CONVERSION 

20 FRINT *fO YOU WANT TO ENTER LOWER CASE CHARACTERS (CY OR N) "3 

30 INFUT AS 

40 IF Ag="¥" THEN 100 

45 IF Ag="u" THEN 100 \ REM Check for lower case y 

SO TF ASe>"N* THEN TF Ages ?*m" THEN 20 \ REM Check for lower case n 
60 A=SYS(7Z91%) \ REM DISABLE LOWER CASE 

70 GO TO 32767 

100 A=SYSGC7K%70%) \ REM ENABLE LOWER CASE 

32767 ENDL 


REALTY 


Peay 
NO YOU WANT TO ENTER LOWER CASE CHARACTERS (CY OR ND? mn 


REALY 
SAVE LOWCHM 


REALTY 


T£ you type lower case letters when lower case is disabled, they are 
echoed aS upper case. 


Note that BASIC converts lower case keywords and variable names to 
upper case characters but leaves string constants, strings entered at 
the terminal, and remarks unchanged. 


CHAPTER 4 


USING ASSEMBLY LANGUAGE ROUTINES WITH BASIC 


4.1 INTRODUCTION TO ASSEMBLY LANGUAGE ROUTINES 


BASIC-11 allows you to add assembly language routines (ALRs) to expand 
or extend BASIC's capabilities. For example, you can write routines 
for communication with special devices (such as laboratory equipment) 
or to manipulate arrays. Once added to BASIC, such routines can be 
executed in immediate mode or in programs, by means of the CALL 
Statement. (See the BASIC-11 Language Reference Manual.) applications 
programs. There are several advantages to doing this rather’ than 
doing all your programming in assembly language. They are: 


e Only the programmer writing the routine need know assembly 


language. The application programmers need only to know 
BASIC. 


e It is easier to write, debug, and modify BASIC programs’ than 
assembly language programs. You can write, execute, debug, 
and modify your program without leaving BASIC. 


@e You can execute ALRs without writing a program, using 
immediate mode CALL statements. 


NOTE 


This chapter assumes that you are an 
experienced MACRO-11 programmer and that 
you are familiar with your operating 
system and its utility programs 
(editors, MACRO assemblers, task 
builders, linkers, etc.) 


This chapter describes: 
e ALR format. 
e The procedure to access arguments. 


e Use of auxiliary routines provided by BASIC, 


See the BASIC-11/RT-11 Installation Guide for the procedure to add the 
routines to BASIC, 


ALRs that use the FORTRAN IV call interface (as defined in RT-1ll 
FORTRAN IV User's Guide) can be called from either FORTRAN IV or RT-11 
BASIC. However, these ALRs must not accesS any routines or global 
locations in FORTRAN IV itself. 
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4.2 FORMAT OF THE ASSEMBLY LANGUAGE ROUTINE 


To write an assembly language routine (ALR) that you can add to BASIC, 
you first must specify the name of the routine and its starting 
address in the user routine Name Table (See Figure 4-1). You must 
include a pointer for each ALR after the global location FTBL. Each 
pointer specifies the location of the routine name and starting 
address. A word containing all O's terminates the pointer list. 


NOTE 


ALR names must not contain embedded 
blanks. For compatibility with FORTRAN, 
routine names longer than six ASCII 
characters should be avoided (although 
BASIC imposes no length restriction 
other than the limit of the program line 
size). 


Routine Name User Routine Name Table 
Ist character Number of characters Pointer to 1 : 
of routine name in routine name ee eee tare 
3rd character 2nd character of Poi ‘ 
of routine name routine name dinter to 2nd routine name 
Pointer to 3rd routine name 







FTBL 






























0 if needed 






Last character af 
routine name 


Pointer to starting address of routine 








Pointer to last routine name 








| 


Figure 4-1 User Routine Name Table and Routine Name Formats 





The BASIC software kit includes a file BSCLI.MAC, with global location 
FTBL. This file is the basis of the pointer table. You build the 
pointer table by adding entries between global location FTBL and the 
-WORD O entry, using the system editor. 


Normally, placing the ALR's routine name at the beginning of the 
routine is recommended. In this case the pointers in the user routine 
name table should be globals. For example, if you have written three 
routines named INITIT, ADDER, and CHKSTA, the routine name list should 
be: 


. 
. 


»GLOBL. ETARL 

»GLOEL INTTNMy ADDINMs CHKSNM 
FTABL! WORE FTBL q 
TEI ¢ WORT INTTNM SUSER ROUTINE 

WORD ALIIINM $NAME LIST 

WORD CHKSNM 

«WORT 6 

+ 
ENE 
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NOTE 


You should edit the items printed in red 
in this listing into the file BSCLI.MAC. 
The items printed in black are already 
in the file. 


The locations, INITNM, ADDNM, and CHKNM should be at the beginning of 
the INITIT, ADDER, and CHCKST, respectively. For example: 


3 THE INIT ROUTINE 
*GLOBL INTTNM 
INT TNMS +RYTE INUMBER OF CHARACTERS TN NAME 
+ASCIT "INITIT" 
+ EVEN 
«WORT INITST 
INTTSTS SSTART OF ROUTINE 


An alternative method is to add the routine name and starting address 
after the routine name table. In this case the starting addresses of 
the routines should be globals. Using the same examples as above, the 
routine name table should be: 


+GLOBL FTART 
»GLOBL TNITSTs ALNSTs CHKSST 
FTABT? «WORT FTStL. 
FTBL? «WORD INT TN 
»WORK ATIINM 
+WORT CHRSNM 
eWORT ¢) 
INITNM? «BYTE & SNUMBER OF CHARACTERS IN NAME 
“ASCII "“INITIT" 
«EVEN 
«WORT INITST 
ATINM BYTE a 
eASCIT "ATER" 
eEVEN 
WORK ANS T 
CHRSNM? +RYTE & 
+ASCIT "CHKSTA" 
sEVEN 
«WORD CHKSST 
«ENE 


Each ALR should start with the global address specified. For example: 


3 THE JNITIT ROUTINE 
+ GLOBL. INITST 
INITST: SSTART OF ROUTINE 


+ 
e 


+ 


You should use this alternative method when you are adding an ALR 
written for FORTRAN IV to BASIC. 
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All the examples in’ this chapter use the recommended method (where the 
routine name packet is at the start of the routine). 


Once you have defined the name and starting address of the routine, 
you can write the routine itself. The ALR can use the stack but it 
must ensure that the stack limit is not exceeded. BASIC puts the 
stack limit in R4 before transferring control to the ALR. If you use 
any of the mathematical operations or function routines provided by 
BASIC, ensure that there is enough free space on the stack before 
executing the routine (15 free words for single precision routines and 
30 free words for double precision routines). The ALR must end with 
an RTS PC instruction with the stack unchanged from its original 
State. The format of the INITIT routine is: 


3 THE INIT ROUTINE 
+ GLORBL INI TNM 
INT TNM? BYTE 6 
“ASCIT "“INITIT" 
+ EVIEN 
WORD INITST 
INITST? ISTART OF ROUTINE 


+ 


oy 


MAIN BODY OF ROUTINE 


* 


RTS FC FEND OF ROUTINE 


4.3 ACCESSING THE ARGUMENTS - THE ARGUMENT LISTS 


When BASIC executes the CALL statement, it evaluates the arguments and 
provides the routine with two lists. One contains pointers to the 
evaluated arguments and the other contains descriptors of the argument 
types. An assembly language routine (ALR) should ensure that the list 
contains the expected number and the right type of arguments. 


Argument checking ensures that errors in a BASIC program will not 
cause a fatal error in the ALR or in BASIC itself. If no argument 
checking is done and a CALL statement contains an incorrect data type, 
the ALR produces unpredictable results. For example, if the ALR 
expects an integer array and the CALL statement contains a = string 
expression, the ALR could overwrite sections of the stack. If the ALR 
checks arguments for errors, it can protect itself from errors in 
BASIC programs. (There is no protection from errors in the ALR 
itself.) 


A FORTRAN-compatible ALR cannot check arguments unless it first checks 
and determines that the language calling it is BASIC, because FORTRAN 
does not provide an argument descriptor list. 


Before BASIC transfers control to the ALR, it evaluates the arguments 
in the CALL statement. It creates a list of pointers to the arguments 
and a list of argument descriptors. Figure 4-2 shows the argument 
descriptor lists that BASIC creates before it transfers control to the 
ALR. 
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Argument Descriptor List 










Pointer to descriptor List 


| {D Byte Number of Arguments —) Pointer to List R5 


| Pointer to 1st argument 


Pointer to 2nd argument 1 
. Argument 
Descriptor of last argument [Ae eee Pointer 
List 
Pointer to fast argument 


Figure 4-2 Assembly Language Routine Argument Lists 


Descriptor of 1st argument 








Descriptor of 2nd argument 





























As shown in Figure 4-2, R5 points to a word that specifies the number 
of arguments in the CALL statement and identifies the language calling 
the ALR. The argument pointer list starts at the next word and the 
pointer to the argument descriptor list is stored in the previous 
word. 


Each byte of the word pointed to by R5 is meaningful. The low-order 
byte contains the number of arguments. The high order byte identifies 
the language. If the calling language is BASIC, the high order byte 
has a value of 202. If the calling language is FORTRAN IV, the 
high-order byte has a value of 0. 


The pointers in the argument pointer list specify the location of the 
evaluated arguments. There are two exceptions, pointers for null 
arguments and pointers for string array arguments. 


If an argument is null then its pointer does not point to that 
argument but instead contains a _ value of -l. A CALL statement 
argument list with two adjacent commaS or a terminating command 
produces a null argument. For example, CALL "INITIT" (A, Br, D,) 
produces the following arguments: A, B, null, D, and null. 


If the argument is a string array, then the pointer does not point to 
that argument but instead contains a value needed to access the string 
array. (See Section 4.3.2.) If the argument is an unsubscripted 
string or an element of a string array, the pointer specifies the 
location of the first character of the string. 


The argument descriptor list specifies the data type of each argument. 
It also indicates whether the argument is an array or not and whether 
the ALR can return a result in the argument. 


BASIC provides additional information for strings and arrays. In 
these cases the word in the argument descriptor list is a pointer to 
the descriptor word, which has the additional information after it. 
Figure 4-3 describes the format of the descriptor word. BASIC 
indicates if a word in the list is a pointer or a descriptor word by 
the value of the 0 bit. If the 0 bit is clear, then the word in the 
descriptor list is a pointer. If the 0 bit is set, then the word in 
the descriptor list is the descriptor word. Note that the descriptor 
word for strings and arrays has a value of 0 in the 0 bit. 


NOTE 


All numbers in this chapter that specify 
the contents of a word or a section of a 
word are octal numbers not decimal 
numbers. 
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is] | s| E 11] 10] 9 s | 7 6 5 4 [2 | 1 0 
T 
Array Size of Read Data Type More Than 
Data Type Onty One Word 
Descriptor 
Contents of Contents of Contents of 
Argument Type Bits 15-13 Argument Type Bit 7 Argument Type Bit O 
Single value 0 Variable 0 Numeric Scalar 
Array 1 Expression 1 Numeric Array 
(Read Only} 
Null 0 String Scalar 
Null 1 
String Array 
Null 
LL at _t 
ror eee 
Contents of Contents of 
Aigument Type Bits 12-8 Argument Type Bits 6-1 
Integer 2 Integer 11 
Single Precision 4 Single Precision 20 
Floating Point Floating Point 
Number Number 
Double Precision 10 Double Precision 21 
Floating Point Floating Point 
Number Number 
String 2 String 
Null Argument 0 Null Argument 











Mee 





Figure 4-3 Format of the Argument Descriptor Word 


The ALR can return arguments only to variables and arrays. If the 
argument is an expression, constant, or element of a virtual array, 
the seventh bit of the argument descriptor word is set and the ALR 
must not return a value to that argument. 


Bits 12 through 8 of the argument descriptor word specify the size of 
the data _ type. The ALR does not need to check this information 
because each argument type (specified in bits 6 through 1) has a fixed 
size. The contents of bits 12 through 8 for a string argument can be 
ignored. 


BASIC provides additional information for array and string arguments. 
BASIC specifies the total number of bytes in the array, the number of 
subscripts, the high limit of the first subscript, and the high limit 
of the second subscript (if there are two subscripts). BASIC also 
provides a string reference pointer for string arguments. This 
pointer is used by routines provided by BASIC to access the string 
arguments. See Section 4.3.2 for a description of these routines. 
Figure 4-4 describes the format of array and string descriptors. 
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Descriptor word for numeric scalar | 














Array Size (bytes) 


0 Number of Subscripts 


























































Array 
Descriptor " Descriptor word for numeric scalar 
Pointer to array descriptor 
High limit of 1st subscript 4 
Descriptor word for numeric scalar : 
If there 
are two Pointer to string scalar descriptor 
High limit of 2nd subscript subscripts 
Descriptor word for numeric scalar 
a 
String Descriptor word 
Descriptor 


String reference pointer 


Figure 4-4 Format of Array and String Argument Descriptors 


4.3.1 Numeric Arrays 


If the CALL statement specifies an element of a numeric array, for 
example A (10), BASIC considers it a l-dimensional array starting with 
the specified element and ending with the last element of the array. 


BASIC considers it a one-dimensional array even if the entire array is 
two-dimensional. 


BASIC and FORTRAN IV store arrays differently. BASIC array subscripts 
start at 0, but FORTRAN array subscripts start at 1. In BASIC arrays, 
the second subscript varies faster, but in FORTRAN IV arrays the first 
subscript varies faster. If you are designing a routine to be called 
from either BASIC or FORTRAN IV, you must consider these differences 
in the ALR. 


4.3.2 Strings and String Arrays 


This section describes the routines BASIC provides to allow the 
assembly language routine (ALR) to access strings. It also describes 
some example routines which use these string access routines. BASIC 
allows dynamic-length strings, whose length can change during program 
execution. The BASIC string access routines keep track of the 
location and size of strings. Consequently, an ALR cannot change a 
BASIC string without using the string access routines. 


The procedures for accessing strings and for accessing elements of 
string arrays are different. Note that if the CALL statement 
specifies an element of a string array (for example, AS$(10)), BASIC 
considers it a string scalar. Only if the entire array is passed (for 
example, AS()), does BASIC consider it a string array. 
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The ALR must locate and retrieve the string reference pointer word and 
pass it to the string access routines. For a string argument, the 
string reference pointer is the word following the descriptor word. 
For a string array argument, The ALR must calculate the string 
reference pointer to access any element of the array. The string 
reference pointer is a word whose value is determined by the following 
formula: 


string reference pointer=2*offsettargument pointer 


where? offset is the position of the element in the 
array. 
argument pointer is the value for the string array in the 


list of argument pointers. (Note the 
argument pointer for a string array does 
not point to the argument itself.) 


The offset for an element of a one-dimensional array is equal to the 
value of its subscript. The offset for an element of a 
two-dimensional array is defined by this formula: 


offset=subscriptl* (maximum value of subscript2+1l)+subscript2 
For example, consider two arrays A$(10) and BS$(3,5) with argument 


pointers of A and B_ respectively. (NOTE: All numbers’ in the 
following list are decimal.) 


Element 2*offsett+argument pointer string reference pointer 
AS (0) 2*0+A A 
AS (4) 2* 444 8+A 
BS (0,5) 2* (O*6+5)+B 10+B 
B$(1,5) 2* (1*64+5) +B 22+B 
BS (2,0) 2* (2*6+0)+B 24+B 


The string access routines use the string reference pointer that the 
ALR provides to find and manipulate the string. 


BASIC provides four string access routines: 


SFIND 
SALC 
SSTORE 
SDEALC 


The $FIND routine returns the length of a string and a pointer to the 
first character. The $ALC routine allocates a temporary String. An 
ALR can only write characters directly to strings created by SALC. 
The $STORE routine assigns the value of one string to a second string 
and changes the first string to a null string. The $DEALC routine 
deallocates space used by the temporary String on the stack. 


The ALR should use the following general procedure to Manipulate a 
string argument and then return the resultant string. First, the ALR 
accesses the string argument by using the SFIND routine. Then it 
creates a temporary string with the SALC routine. It then reads the 
characters of the string argument, manipulates them in the desired 
way, and writes the characters out to the temporary String. After 
this the ALR uses the SSTORE routine to copy the temporary string to a 
string argument (which can be the original string). Finally, it uses 
the $DEALC routine to remove data placed on the stack by the SALC 
routine. 
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Table 4-1, "Using String Access Routines", describes the four string 
access routines. It describes the initial setup, including the format 
of the subroutine jump (JSR) instruction required to invoke the string 
access routine. It also describes the expected results and how to 
interpret them. (In particular, it indicates how to determine whether 
or not you made a correct initial setup in preparation for the string 
access routine.) 


If the ALR calls SFIND, SALC, S$STORE, and $DEALC, it must specify them 
as global locations. 


Before calling any of these routines, you must ensure that R5 contains 
its initial value, the value it had when BASIC transferred control to 
the ALR. That is, R5 must point to the word identifying BASIC and 
specifying the number of arguments. 


NOTE 


These routines require that a _ register 
contain the same value in bits 6-1 as an 
argument descriptor word for a_= string 
argument. You can ensure this by moving 
a value of 100 into the specified 
register (puts a value of 40 in bits 
6-1) or by moving an argument descriptor 
word in the specifed register. 


4.4 USING ROUTINES PROVIDED BY BASIC 


BASIC provides routines that handle error conditions, print messages 
on the terminal and perform mathematical operations and functions. 


4.4.1 Error Handling and Message Routines 


BASIC provides two error handling routines ($ARGER and $BOMB) and _ two 
message printing routines (S$MSG and S$CHROT). The SARGER routine 
produces the fatal ?ARGUMENT ERROR (?ARG) message. The ALR should 
call SARGER when it detects an incorrect argument. The $BOMB routine 
allows the ALR to specify its own fatal message. The SMSG_ routine 
prints any message on the terminal and then returns control to the 
ALR. The SCHROT routine prints any single character on the terminal 
and then returns control to the ALR. 


If the ALR calls SARGER, SBOMB, S$MSG, or $CHROT, it must specify them 
as global locations. 


Call the SARGER routine by executing the instruction: 
AMF BARGER 


The SARGER routine prints the error message on the terminal in one of 
the following formats: 


PARGUMENT ERROR AT LUNE xxxxx 
PFARG AT LINE XXxXxx 


wheres: 


XXXXX is the line number of the CALL statement. 


OT-? 


Table 4-1 
Using String Access Routine 


Routine Program Setup Result With No Errors Detected 


$FIND RO+string reference RO = address of first string 


Result With Errors Detected 


RO contains error code: 






































(return location pointer character if RO=1, Rl did not equal 100 
and length of R1<100 Rl = length of string if RO=2, R5 did not contain correct 
string) R5¢initial value R2 = 100 initial value 















Execute: JSR PC, $FIND R3,R4,R5 unchanged 
C-bit = 0 (char) 
Z-bit = 1 if a null string 


(R1=0) 







R3,R4,R5 unchanged 
C-bit = 1 


























































SALC RO«required string length RO = address of first string RO contains error code: 
{allocate temporary R1<«100 character if RO=0, indicates insufficient 
string) * R5einitial value Rl = length of string free space for requested string 
Execute: JSR PC, SALC R2 = 100 if RO=l1, Rl did not equal 100 
R3,R4,R5 unchanged if RO=2, R5 did not contain correct 
C-bit = 0 initial value 
Z-bit = 1 if a null string (R1=0) 
SP = string reference pointer R3,R4,R5 unchanged 


stack contains several words of C-bit = 1 
internal pointers. Remove these 
worus from the stack by the 


SDEALC routine 


















































$STORE 
(store value of a 
string in a second 
string, make first 
string null) 


RO contains error code: 
if RO=1, R2 did not equal 100 
if RO=2, R5 did not contain correct 
initial value 


RO«string reference pointer 
of string to be copied 
Rl+string reference pointer 

of receiving string 
R2+100 
R5¢initial value 
Execute: JSR PC, S$STORE 


RO,R1,R2,R3,R4,R5 unchanged 

C-bit = 0 

string whose pointer was in 
RO is null 

string whose pointer was in 
Rl contains former value of 
the other string 


















R1,R2,R3,R4,R5 unchanged 
C-bit =1 




































SDEALC 
(remove from stack 
the internal pointers 
produced by SALC 
routine) * 


Return stack to the state 
that it was immediately 
following S$ALC routine. Do 
this by removing any words 
you have added to the stack 
since calling the SALC 
routine; this ensures that 
the string reference pointer 
is in the SP. 

R2<100 

R5«initial value 
Execute: JSR PC, $DEALC 


RO,R1,R2,R3,R4,R5 unchanged 
C-bit = 0 

Stack returned to the state 
that existed before SALC 
was called 


RO contains error code: 
if RO=1, R2 did not equal 100 
if RO=2, R5 did not contain correct 
initial value 












R1,R2,R3,R4,R5 unchanged 
C-bit =1 
Stack 












*Any temporary string created by SALC must be removed by $DEALC before the ALR ends. 


OISWd HLIM SANILNOWY AOWNONVI ATEWASSY ONISN 
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If the CALL statement was an immediate mode statement, then AT LINE 
xxxxx is not printed. Control then returns to BASIC, which prints the 
READY message. 


Call the $BOMB routine by executing the following instruction: 


JSR Ri» $ROMB 
sASCTZ 'message' 
+EVEN 


where: 
message is the string of characters that you wish to print. 


The S$BOMB routine prints the error message on _ the terminal in the 
form: 


error message “7 LINE xxxxx 
where: 

XXXXX is the line number of the CALL statement. 
If the CALL statement was an immediate mode statement, then AT LINE 
xxxxx is not printed. Control then returns to BASIC, which prints the 
READY message. 
Call the $MSG routine by executing the instruction: 

JSR Fly #46 

+ASCIT 'message' 

+RYTE Ly Lavo MUST HAVE CARRIAGE RETURN 

»EVEN SAND LINE FEED ANG END WITH © 
wheres; 

message is the string of characters that you wish to print. 
The SMSG routine prints the message you specify on the terminal, and 
then returns control to the instruction that follows the .EVEN 
instruction. 


Call the SCHROT routine as follows: 


1. put the 8-bit ASCII code of the character in the low order 
byte of RU 


2. execute the instruction: 
JSR FCs €CHROT 


SCHROT prints the character specified in RO on the terminal, and then 
returns control to the ALR. 


4.4.2 Mathematical Operation and Function Routines 


Assembly language routines (ALRs) can use BASIC's mathematical 
operation and function routine to perform operations and functions 
that you can use in a BASIC program. ALRs can use the same routine 
that BASIC itself uses to perform these operations and functions. An 
advantage of this is that the ALR need not duplicate routines that 
already exist in BASIC. 
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NOTE 


Assembly language routines that use the 
FP11 Floating Point unit are required to 
save and restore the FPU status. If the 
assembly language routine will modify 
the FPU status, it must preserve the FPU 
status on entry by executing the 
following instruction: 


STFPS ~ (SP) 


and restore the status (prior to 
returning to the calling program) by 
executing the instruction: 


LDFPS (SP) + 


Tables 4-2 and 4-3 describe the BASIC mathematical operations and 
functions. They show how each operation or function would appear in 
the BASIC language, and name the BASIC-provided routine that will 
perform it. Note that certain operations and functions require one 
routine for single precision arithmetic, a different routine for 
double precision arithmetic, and yet another for integer arithmetic. 


If you are running a BASIC system designed for double precision 
arithmetic, either the single or double precision routine names can be 
used. Either routine name will execute the double-precision routine; 
this fact allows you to use the same code for different systems 
regardless of precision. However, you must still be aware of which 
precision you are using, and ensure that the data manipulations in the 
program properly reflect the BASIC configuration on which programs are 
running. To be compatible with FORTRAN IV, you must use only the 
double precision routine names to execute the double precision 
routines. 


All routines that have a dollar sign (S$) in their name must be called 
in threaded code mode. To call routines in threaded code mode, first 
call a special subroutine, $POLSH. After calling S$POLSH, list the 
names of the threaded code routines you wish to call. In threaded 
code mode, each routine is executed in the order listed. All 
arguments and results are passed on the stack. Finally, list the name 
of a second special subroutine, S$UNPOL, which ends threaded code mode. 


You must specify $POLSH, S$UNPOL and any routine names you specify as 
globals. 


The call to $POLSH is in the following format: 
JSR Ray $POLSH 


Figure 4-5 describes the state of the stack before and after each 
threaded code routine. 


USING ASSEMBLY LANGUAGE ROUTINES WITH BASIC 


Table 4-2 
BASIC Mathematical Operations 


Single- Double 
Precision | Precision 
Routine Routine 


BASIC 


Operation Operator Meaning Equivalent 


Addition Adds two floating 
point numbers 

Subtraction Subtracts one floating 
point number from 


another 


Multiplication Multiplies two floating] C=A * B 
point numbers 


Multiplies two integers] C%=A%*B% 


Division : Divides one floating C=A / B 


point number by 
another 


Divides one integer 
by another integer 


Exponentiation Raises a floating 
point number by a 
floating point ex- 
ponent. 


Raises a floating 
point number by an 
integer exponent. 


Raises an integer by CS=A% “BE 
an integer exponent. 





Table 4-3 
BASIC Mathematical Functions 


Single- Double 
Precision | Precision 
Routine Routine 


BASIC 


Function Description Equivalent 


Data type Converts floating point number 
conversion to integer 


Converts integer to floating 

Truncation Truncates a floating point B=SGN (A) * 
number to a floating point INT (ABS (A) ) 
whole number 


Sine Finds the sine of a radian B=SIN(A) 
value 


Cosine Finds the cosine of a B=COS (A) cos pcos 
radian value 


Finds the arctangent in B=ATN (A) ATAN DATAN 
radians of a number 


Logarithm Finds the natural log B=LOG(A) ALOG DLOG 
{base e) of a number 


Finds the common log B=LOG10 (A) ALDG1O DLOG1O 
(base 10) of a number 


Square root] Finds the square root of B=SQR(A) SORT DSORT 
a number 


Exponential | Finds the value of e B=EXP (A) EXP DEXP 
raised to a number 





Routine 
Names 


$ADR 
$SBR 

$MLR 
$DVR 
$ADD 
$SBD 

$MLD 


$DVD 
XDD$ 


$MLI 
$DVI 
XING 


XFIS 


XDIS$ 


$RI 


$DI 


$IR 


$ID 


SINTR 


$DINT 
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Equivalent 
BASIC 
Statement 


C=AtB 
C=A-B 


C%=A%*B% 
C%=A%/B% 
C%=A%~*B% 


C-A~B% 


C=A*B% 


B%=A 


B%=A 


B=A% 


B=A% 


B=SGN(A)* 


INT(ABS(A)) 


B=SGN(A) « 


INT(ABS(A)) 


Stack Before 
Execution 


High-order FP word 
Low-order FP word 
High-order FP word 
Low-order FP word 
High-order FP word 


Low-order FP word 
Lower-order FP word 


Lowest-order FP word 
High-order FP word 


Low-order FP word 
Lower-order FP word 
Lowest-order FP word 


B% 
A% [Integer word | 







is] 





> 
































Stack 
pointer 








High-order word 
Low-order FP word 


Integer word 


High-order FP word 
Low-order FP word 
Lower-order FP word 
Lowest-order FP word 



















High-order FP word 


Stack 
pointer 





Low-order FP word 


High-order FP word 
Low-order FP word 


Lower-order FP word 


Lowest-order FP word 
A% 











| 
7 
| 


Stack 
pointer 


Stack 
pointer 


a [Integer word | 


A 


a 





High-order FP word 
Low-order FP word ea 

High-order FP word 
Low-order FP word 


Lower-order FP word 
Lowest-order FP word 
















Note: FP stands for Floating Point 


Figure 4-5 


Stack After 
Execution 


C High-order FP word 
Low-order FP word i 














Stack 
pointer 







High-order FP word 
Low-order FP word 
Lower-order FP word 
Lowest-order FP word 














Stack 
pointer 


Stack 
pointer 
Stack 
pointer 


C% [Integer word | 


c { -High-order FP word 
Low-order FP word 







High-order FP word 
Low-order FP word 


Lower-order FP word 
Lowest-order FP word 








Stack 
B% | integer word ‘ 
pointer 
Stack 
B% | Integer word : 
pointer 


High-order FP word 
Low-order FP word 


High-order FP word 

Low-order FP word 
Lower-order FP word 
Lowest-order FP word 


Stack 
pointer 
Stack 
pointer 


B 















High-order FP word 
Low-order FP word 


High-order FP word 


oO 


Stack 
pointer 
Stack 
pointer 







Low-order FP word 
Lower-order FP word 
Lowest-order FP word 









State of Stack for Threaded Code Routines 


USING ASSEMBLY LANGUAGE ROUTINES WITH BASIC 


As examples, consider the following segments of routines: 


Segment 1 divides an integer stored in TEMP1 by an integer stored in 
TEMP2 and stores the quotient in RESULT. 


§ SEGMENT 1 


+GLOBL. $F OL SH s $UNFOL » BOY T 











MOV TEMP Le CSF) rf THE 

MOV TEMP ay (SF) ms 

JSR R42 $F OUSH SENTER THREATEN CODE MOQUE 
WORT $NVI PSPECTFY ROUTINE NAME 
+WORT $BUNF OL JLEAVE THREATEN COTE MOXUE 
MOV (SFP O49 RESULT ISTORE RESULT 


TEMFP1? «WORK .¢) 
TEMF2 +WORT 0 
RESULT WORT 9 


Segment 2 multiplies two single-precision floating point numbers, 
FLOATA and FLOATB, and stores the product in FLOATC. 


#SEGMENT 2 


+GLOBL $FOLSH»y UNF OL » MLA 


MOV FLOATAES y- CSF) sPUT FLOATA 

MOV FLOATAs~ CSF FON STACK 

NOV FLOATE +2 y= (SFO aPUT FLOATS 

MOV FLOATE » = (SF) §0ON STACK 

JSR R49 $F OL SH IENTER THREADED CODE MOE 


»WORT $M ISPECTIFY ROUTINE NAME 
WORT $UNF OL SLEAVE THREATEN COtE MONE 
MOY (SP) +9FLOATC 









MOV (SPateFLOATCHS 
FLOATA? «WORT 0x9 


FLOATB? «WORK 990 
FLOATC? «WORT Od 


Segment 3 converts a double-precision floating point number stored at 
FLOAT to an integer and stores it at INTMDW. 


FSEGMENT 3 
+ GLOBL. $POL GSH sy $UNF OL » $07 


MOV FLOATH Gy ~ CSF) sFPUT FLOAT 
MOV FLOAT+4 9 CSF S SON STACK 
MOV FLOATH2 9- CSF) SKEEP DOING IT 
MOV FLOAT y= CSF) sTONE. 
JSR Réy $F OLSH sENTER THREADED CODE MONE 
+WORG OT ISFECTIFY ROUTINE NAME 
WORT $UNF OL, gLEAVE THREAMER CORE MOTE 
MOV (SP aby INTMOW SSTORE RESULT 

FLOAT? «WORT Ov OrQvdO 

INTMOW? oWORD 0 


Although the foregoing examples have only one routine name after each 
call to $POLSH, you can specify any number of routine names. You must 
always follow the last of routine name with the $UNPOL routine. 
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The sine, cosine, arctangent, logarithm, square root, and exponential 
routines each use an argument list similar to the BASIC CALL argument 
list. An ALR must establish the argument list before calling the 
routine. The format of the argument list for the single-precision 
routines, SIN, COS, ATAN, ALOG, ALOG1O, SQRT, and EXP, is: 











R5 


Po mT i 


Pointer to tist 





High-order FP word 
Low-order FP word 
Figure 4-6 Argument List for Supplied Single-Precision Routines 


The format of the argument list for the double-precision routines, 
DSIN, DCOS, DATAN, DLOG, DLOG10, DSQRT, and DEXP is: 


R5 







Pointer to argument 


Pointer to list 





High-order FP word 
Low-order FP word 
Lower-order FP word 


| Lowest-order FP word 


Figure 4-7 Argument List for Supplied Double-Precision Routines 











In both cases, the routines are called by the instruction: 
dSR PC, routine name 


The single-precision routines return the result in RO and Rl; the 
high-order word is in RO and the low order word is in Rl. 


The double-precision routines return the result in RO, Rl, R2, and R3. 
The high-order word is in RO and the low, lower, and lowest order 
words are in Rl, R2, and R3, respectively. 


You must specify as global any routine name that you call. 


These routines do not preserve any registers. 


NOTE 


You should save the initial value of R5° 
before loading the pointer to the 
argument for these routines. You will 
need the saved value to execute any 
threaded code routine to access 
arguments. 


Consider the following segment of a routine that finds the square root 
of a single-precision floating point number, NUM1, and stores the 
result in NUM2: 


sSEGMENT WHICH 


+ GLO. 
MOV 
MOV 
MOV 
MOV 
ASR 
MOV 
MOV 
MOV 
MOV 
MOV 


ARGS «WORT 
»WORT 
eWORD 
+WORT! 
NUMIG PLT 
NUM 3 FLT 
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FINDS SQUARE ROOT 


SART 

Ray TEMPS 
Rie TEMP I 
RQ» TEMPO 
FARG: RS 
PCy SQRT 
RO» NUM 
Riv NUM2+2 
TEMPS 9» RG 
TEMP Ly RL 
TEMP Os RO 


1. 
NUMA. 
6) 
9 
4 
ce) 


SSAVE OLD VALUE OF RS 
§SAVE ANY OTHER REGISTER 


sSET UF RS 

sCALL ROUTINE 

ISTORE HIGH ORDER RESULT 
SS8TORE LOW ORDER RESULT 
sRESTORE SAVET 
IREGISTERS 


The following example is a complete assembly language routine. This 
routine can be called by the following statement: 


CALL MYFOTCAy By ly O42) 


The routine calculates the 
assigns ‘the value to C, and assigns the truncated value to C%. 


«TITLE 
+PSECT 


+ GLOBL 
HYF TAR? «BYTE 
AASCIT 


«EVEN 
+WORT 


+GLOBL 
o GLO BL. 


HYPOTE CMP 
BEQ 

LOw:e JME 

208s CMP 


BNE 





eASOTZ 
EVEN 
SObs MOV 





HYFOT 
SUBRS yROy T 


HYP TAR 


a 


“HYPOT’ 


HYFOT 


value of the expression SQR(A*A+B"2), 


SARGER s HROME » $F OLGH » BUN OL, 
$MLRy XF Lb y $ALIKRYGART y SRT 


CRS) by RA 
20h 

BARGER 
CRS by R208 


&Oh 


BP y RS 

FBO. RS 

RB RA 

BO 

Fl» SROME 

‘STACK OVERFLOW 


wo ACR Dy RA 


PCy GETESC 
LGORO 1 e RS 
2040 y RS 

tt 
BC» GETOSC 







ARE THERE 4 ARGUMENTS? 

HYES « 

INO» ISSUE ARGUMENT ERROR. 

FARE WE NG OC SO BY RAST 
RIF TORS? 
















IWITH ARGUMENT “nl 
gNO. 






CHECK THAT THIET 
PSTACK SI Be BO. BYTES 

SURE EC TE 
SSUBTRACT 30. FROM THE CURRENT SF VALUE. 


IS ENQUGH 
SHOULI TE 





p18 IT BELOW THE LM0T? 
gNOe 
HYES» ISSUE MESSAGE. 


TN HYPOYT*? 














OF T 
Val. 


OR 


THE THE : 
Al. 


i GE 
q iT aA 2 W 


rs 


yas 









gNQe 
SYES» GET THE DESCRIFTOR OF THE 2N0 ARGUMENT 
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SOb? 





MOV 
NOW 
MOV 
JSR 


SMLA 


$UNFOL, 


MOV 
MOV 


MOV 
MOV 


JSR 
XFI¢ 
SATIN 


$UNFOL 


MOV 
MOV 
TST 
MOV 
MOV 
MOV 
ASR 
CME 
MQY 
MOV 
MOV 
MOV 


MOV 
MOV 
JSR 


BRT 


SUNF OL, 


MOV 


RTS 


HLGO201 RS 
HLOAG y RS 
LO8 

Ce GE 
#1 GOGOL RS 
HAA o FS 
LO€ 
tle GE TISC 
ELGOQOOE she 
LOR KS 
LO 
CRY) Fe ke 
SCRS) vm ¢ 
CRB y= CS 
2ORBY y= CSE 
CRS) ye CSP) 
Ray $E OL SH 











CRED + RS 

2CR3) y= CGE 
CRB CGF 

#29 -(SF) 


R49 $F OL SH 





RG y~ (SF) 
Bly (SF) 
SP y RG 

PCs SQkT 
(SPO ty CSE y+ 
CSP) +9 RS 
CR) te RS 
RGy CRSI+ 
Riv (RB) 


Rig? 


RO» CSF 
R4ay€P OL SH 





CSP +9 @ CRS) + 


Fe 





Ap gs 


54S 


IT ALSO 


INO. 





318 IT A a 
BNO. 
SGET THE DE 
$15 
sNO. 
jPUSH 
SNOTES 


LT AN fT 


THE 
LOW 


IFPUSH 


eAxA TO GET 


#00) THE MUL. 


yPUSH 


#FUSH A 2 


TOOTHED QESCRT 





A 2 WORT 


PTOR 0 


WORT 





SCRIFTOR 0 


NTEGER WIT 


IST ARGUMENT 


rs F 


OR THER 


IT AGAIN BECAUSE WE 


ATR. 
TIELY « 


NG ARGUMEN 


BECAUSE WE WILL 


. WITH WRETING 
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REAL? 


FTE 





ARGUMENT « 


ALL OWE? 


FOTHE 4TH ARGUMENT. 


HOWE TING 





ON Th 
USHETE FE 


WILL 00 


T e 


#TO INTEGER EXFONENTIATION. 


sSQUARE THE 
FAL SQUARE 
7OF FIRST A 


2NIt ARGUM 


ENT. 


USE REAL 


ALLOWED? 


OF 2ND ARGUMENT TO SQUARE 


RGUMENT. 


yNOW CREATE ON THE STACK THE ARGUMENTS 


SREQUIRET B 
sSAVE RS. 


Y SQRT. 


ICREATE POINTER TO VALUE ON THE STACK, 


9GHOW ONLY L ARGUMENT TO SaRT 


GET THE SQ 
» OL 
TORE RS 
sFOINT TO T 
SSTORE THE 

s3R0 ARGUME 
INOTE? SQRT 
PREPLACE TH 
PWITH ITS § 











s CONVERT 


ISTORE THE 
ITHE 4TH AK 
IRETURN TO 


UARE ROOT. 
ARGUMENTS 


HE 





SRI ARG 
lL. RESUL 


NT. 
RETURNS 
iE SUM QF T 
QUARE ROOT 





GUMENT. 
THE CALLER 


fGETISC RETURNS THE NEXT ARGUMENT’S DESCRIFTOR WORT, 


SINPUTSE 


3 R4 FONTS TO 


FOUTFUTS ¢ 

3 RS 
i R4 
GETESC : MOV 
RIT 
BNE 
MOV 
RTS 


+ ENT 


LOG? 


Reacy 


CONTAING 
IS UPUATEL 





THE CHE 


CRA te RS 
Hl y RS 
Lod 

CRS VRS 


BC 


THE WOR 


SCR IE TOR 


TO POINT TO THE 


QE SCR 


THE 


WORT FOR 





9 CHEE 
gS 
jNO- 


9 YIES y 


THE QE 
IT A FO 


GET T 


FTOR LIST. 


THE 








SCRIFTOR » 
INTER? 


HE ACTUAL 


CURRE 
NEXT ELEMENT IN THE 


FROM THE STACK, 


UMENT. 
TIN THE 


TTS 
HE S$ 


e 





RESULT 
BRS oy 


7 
se So 





TO AN TNTEGER, 


+ 


NT ARGUMENT . 
LISt. 


QESCRIETOR. 


IN RO & RL, 


ABORT function, 3-4 
SALC routine, 4-8, 
ALR, advantages of, 
ALR format, 4-2 
ALR, FORTRAN-compatible, 
SARGER routine, 4-9 
Argument checking, 4-4 
Argument descriptor list, 
Argument descriptor word, 
Argument list, 4-4, 4-5 
Argument list, double precision, 
4-16 
Argument 
4-16 
Argument pointer, 4-8 
Argument pointer list, 4-4 
Array, numeric, 4-7 
Arrays, string, 4-7 
Assembly language routine, 4-1 
Assembly language routine, 
FORTRAN-compatible, 4-4 


4-9, 4-10 


4-1 


4-4 
4-4 
4=~6 


list, single precision, 


~BAC file type, 1-8 
Background job, 1-2 
BASIC software kit, 4-2 
BASIC termination, 3-6 
»-BAX file type, 1-8 
SBOMB routine, 4-9, 
BYE command, 1-7 


4-11 


CALL statement, 4-1, 4-4 
Canceling CTRL/O, 3-2 


Checking for CTRL/C, 3-7 


INDEX 


Default device, 2-2 
Default file name, 
Default file type, 
DEL key, vi 
Descriptor list, argument, 4-4 
Descriptor, string argument, 4-7 
Device, default, 2-2 

Device names, 2-1 
DIRECTORY command, 
Disabling CTRL/C, 


2-2 
2-2 


2-4 
3-3 


Enabling lower case, 3-7 
Error handling routines, 
Error messages, 1-8 

ESC key, vi 


4-9 


File 
File 
File 


directory listing, 2-3 
name, default, 2-2 
specification, 2-1 

File type, default, 2-2 

SFIND routine, 4-8, 4-9, 4-10 
Floating point precision, 1-7 
Foreground job, 1-4 

FRUN command, 1-4 
Function, ABORT, 
Function, 
Function, 
Function, 
Function, 
Function, 
Function, 


sys, 
TTYSET, 


SCHROT routine, 


Command, 
Command, 
Command, 
Command, 
Command, 
Command, 


429, 4-11 
BYE, 1-7 
CTRL/C, 1-6 
CTRL/F, 1-4 
DIRECTORY, 
FRUN, 1-4 
RUN, 1-3 


2-4 


CTRL/C checking, 3-7 
CTRL/C command, 1-6 


CTRL/C disabling, 3- 
CTRLC function, 3-3 
4 


3 


3 
CTRL/F command, l- 
CTRL key, vi 


CTRL/O canceling, 


Data type, 
SDEALC routine, 


3-3 


4-5 


4-8, 4-9, 4-10 


Global address, 


Indirect file, 


4-3 


1-5 


LET statement, 3-1 


Link time feature selection, 


1-1 


Lower case characters, 


Mathematical routines, 


4-12, 


Message routines, 
SMSG routine, 


Index-1 


4-13 


4-9, 


4-9 


4-11 


INDEX 


Name table, user routine, 4-2 
Numeric arrays, 4-7 


Offset, 4-8 
OPEN statement, 2+3 
Optional features, 1-1 


Pointer, argument, 4~8 

Pointer list, argument, 4-4 

Pointer, string reference, 
4-6, 4-8 

$POLSH routine, 4-12 

Precision, floating point, 1-7, 
4-16 

Program termination, 3-4 


RCTRLC function, 3-3 

RCTRLO function, 3-2 

RET key, vi 

Routine, SALC, 4-8, 4-9, 4-10 

Routine, $ARGER, 4-9 

Routine, SBOMB, 4-9, 4-11 

Routine, SCHROT, 4-9, 4-11 

Routine, S$DEALC, 4-8, 4-9, 4-10 

Routine, $FIND, 4-8, 4-9, 4-10 

Routine, S$MSG, 4-9, 4-11 

Routine, $POLSH, 4-12 

Routine, $STORE, 4~8, 4~9, 4-10 

Routine, SUNPOL, 4-12 

Routine name, 4-2 

Routines, assembly language, 
4-1 

Routines, error handling, 4-9 

Routines, mathematical, 4-11, 
4-12, 4-13 

Routines, message, 4-9 

Routines, string access, 4-8, 


4-9, 4-10 
Routines, threaded. code, 4-12, 
4-14 
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RUN command, 1-3 
Run time feature selection, 1-1 


Scalar, string, 4-7 

Single character input, 3-6 

Single job monitor, 1-2 

Software kit, BASIC, 4-2 

Stack limit, 4-4 

Starting address, routine, 4-3 

Starting BASIC, 1-2 

Statement, CALL, 4-1, 4-4 

Statement, LET, 3-1 

Statement, OPEN, 2-3 

Stopping BASIC programs, 1-6 

SSTORE routine, 4-8, 4-9, 4-10 

String access routines, 4-8, 
4-9, 4-10 

String argument descriptor, 

String arrays, 4-7 

String reference pointer, 4-6 

SYS functions, 3-5 

System functions, 3-5 


Terminal margin setting, 3-1 

Terminating BASIC, 3-6 

Terminating the program, 3-4 

Threaded code routine, 4-12, 
4-14 

TTYSET function, 3-1 


SUNPOL routine, 4-12 
User routine name table, 4-2 
Utility functions, 3-1 


Wildcard feature, 2-4 
Word, argument descriptor, 
4-6 
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READER'S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. Problems with software should be reported 
on a Software Performance Report (SPR) form. If you 
require a written reply and are eligible to receive 
one under SPR service, submit your comments on an SPR 
form. 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 
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Assembly language programmer 
Higher-level language programmer 
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User with little programming experience 
Student programmer 
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Non-programmer interested in computer concepts and capabilities 
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release of BASIC-11/RT-11 Version 2 on the RLO1 
disk. 


Copyright © 1978 Digital Equipment Corporation 


INSTRUCTIONS 


Place the following pages in the BASIC-11/RT-11 
User's Guide as replacements for, or additions 
to, current pages. The changes made on replace- 
ment pages are indicated in the outside margin 
by change bars (§) for additions and by bullets 
(e) for deletions. 


Old Page New Page 
Title Page/Copyright Title Page/Copyright 
2-1/2-2 2-1/2-2 


3-7/3-8 3-7/3-8 


